home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 5 / Gold Medal Software - Volume 5 (Gold Medal) (1995).iso / music / midas41b.arj / MIDP.DOC < prev    next >
Text File  |  1994-07-04  |  10KB  |  245 lines
  1.         MIDAS Module Player v0.41ß documentation
  2.         ----------------------------------------
  3.    Copyright 1994 Petteri Kangaslampi and Jarno Paananen
  4.  
  5. MIDAS MODULE PLAYER IS PROVIDED "AS IS" WITHOUT WARRANTY OF
  6. ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT
  7. LIMITED TO, WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
  8. PARTICULAR PURPOSE. IN NO EVENT WILL ANY OF THE AUTHORS OR
  9. COPYRIGHT HOLDERS BE LIABLE FOR ANY DAMAGES CAUSED BY THE USE,
  10. OR INABILITY TO USE, OF MIDAS MODULE PLAYER.
  11.  
  12. MIDAS Module Player may freely be distributed as long as no money is
  13. charged for it, and no attempt is made to restrict further copying,
  14. distribution and using of MIDAS Module Player. If you have problems
  15. with this, or do not understand this, contact us.
  16.  
  17.  
  18. MIDAS Module Player is a program for playing Protracker and Scream
  19. Tracker 3 modules. It uses MIDAS Sound System, also by us, which will
  20. be made available for the public soon. Read MIDAS.TXT for more
  21. information about MIDAS Sound System.
  22.  
  23.  
  24.  
  25.         Foreword
  26.         --------
  27.  
  28. This is a public beta-test release of MIDAS Module Player (MIDP). It is
  29. not intended to be the ultimate module player of all time and replace
  30. all other players in the world (yet ;), but to get MIDAS Sound System
  31. properly tested before releasing. MIDP works on every computer that we
  32. have tested it on, but that is not unfortunately too much, and that is
  33. why we are making this release before MIDAS Sound System itself will be
  34. released.
  35.  
  36. What we now want from you is feedback. Run MIDP on your own computer,
  37. experiment with it, bang it with strange modules and try to crash it.
  38. After you know what works and what doesn't, please tell us. The
  39. preferred method is of course via e-mail, because it is fast and
  40. convenient for us and probably free for you. We are most interested in
  41. hearing whether the Sound Devices work on your sound card. So if you
  42. don't have time to experiment with MIDP for a long time, we would
  43. appreciate if you could at least run it once or twice with different
  44. output modes, and tell us whether it worked or not.
  45.  
  46. When giving us feedback, especially bug reports, please remember to
  47. include information about your computer system, especially the type of
  48. your sound card. Please also include, if possible, the MIDAS error list
  49. given by MIDP on an error situation. It gives us invaluable information
  50. about the error and, even more importantly, where that error occurred.
  51. This way we have better chances of finding the bugs.
  52.  
  53. Unlike most other module players, MIDP is not commercial, shareware, or
  54. even cardware. But, if you like MIDP, nothing naturally stops you from
  55. sending us something, money, a postcard or whatever. We would hope to
  56. get at least a "Hey, MIDP works with my xxx sound card" e-mail message.
  57.  
  58.  
  59.  
  60.         Sound Devices
  61.         -------------
  62.  
  63. MIDAS uses all sound cards through modules called Sound Devices.
  64. Currently there are Sound Devices for the following sound cards:
  65.  
  66.         1. Gravis Ultra Sound
  67.                 * Should work with all GUS versions, with any amount of
  68.                   memory, but is not tested with less than 1Mb.
  69.  
  70.         2. Media Vision Pro Audio Spectrum family
  71.                 * This includes PAS, PAS+ and PAS 16
  72.                 * Note that the PAS Sound Device always attempts to use
  73.                   16-bit output unless otherwise told, so with PAS or
  74.                   PAS+ sound cards, you must use the command-line option
  75.                   -o8. In addition to this, with normal PAS you should
  76.                   also set the mixing rate to 22kHz or less, using
  77.                   -m22000. This will be fixed in the near future.
  78.  
  79.         3. Microsoft Windows Sound System
  80.                 * Should also work with other WSS compatible cards,
  81.                   such as Compaq Business Audio, and is tested to work
  82.                   with Audiotrix Pro.
  83.                 * Note that there is no autodetection for WSS, so you
  84.                   must force the correct settings using the command
  85.                   line options (ie. -s3 -p530 -i9 -d3)
  86.  
  87.         4. Creative Labs Sound Blaster series
  88.                 * Fully supports SB 1.0, 1.5, 2.0, SB Pro and SB 16.
  89.                 * SB 16 support has not been tested yet - please inform
  90.                   us whether it works or not on your sound card.
  91.  
  92.         5. No Sound
  93.                 * Plays nothing, is always used when nothing else is
  94.                   detected.
  95.                 * Just to allow sound synchronization even with no
  96.                   sound card.
  97.  
  98. Note that both the GUS and SB Sound Device use direct hardware
  99. detection routines, and might therefore cause problems on some
  100. computers. In that case, simply force the settings from the command
  101. line. This will be fixed in the future, as all detection will be done
  102. using the environment variables.
  103.  
  104.  
  105.  
  106.         MIDP Usage:
  107.         -----------
  108.  
  109. The command line syntax for MIDP is:
  110.  
  111.         MIDP [options] <filenames> [options]
  112.  
  113.         At least one module file name must be included. MIDP also
  114.         supports multiple modules and wildcards.
  115.  
  116. Options:
  117.         -sx     Force Sound Device x (1 = GUS, 2 = PAS, 3 = WSS, 4 = SB,
  118.                 5 = No Sound)
  119.         -pxxx   Force I/O port xxx (hex) for Sound Device
  120.         -ix     Force IRQ x for Sound Device
  121.         -dx     Force DMA channel x for Sound Device
  122.         -mxxxx  Set mixing rate to xxxx Hz
  123.         -oxxx   Force output mode (8 = 8-bit, 1 = 16-bit, s = stereo,
  124.                 m = mono)
  125.         -e      Disable EMS usage
  126.         -t      Disable ProTracker BPM tempos
  127.         -u      Enable Surround sound (affects only GUS)
  128.         -v      Disable real VU-meters
  129.         -------
  130.         -S      Jump immediately to DOS shell
  131.         -c      Disable timer screen synchronization
  132.         -C      Enable timer screen synchronization also in DOS shell
  133.         -Lx     Number of song loops before next song
  134.         -O      Scramble module playing order
  135.  
  136. Also '/' is recognized as option delimiter.
  137. Note that the options are CASE SENSITIVE, so 'o is different from 'O'.
  138.  
  139.  
  140.  
  141.         MIDAS environment variable
  142.         --------------------------
  143.  
  144. MIDAS Sound System specific options (above the line in the command
  145. line option list above) can also be set to environment variable MIDAS,
  146. so that they do not have to be entered every time. The syntax is
  147. exactly the same as with the command line options. Also other programs
  148. that use MIDAS Sound System will probably recognize the environment
  149. variable.
  150.  
  151. Example:
  152.         SET MIDAS=-c3 -p530 -i9 -d3 -om -s32000
  153.  
  154.  
  155.  
  156.         MIDP keys
  157.         ---------
  158.  
  159. When playing a module, MIDP can be controlled using the following keys:
  160. (most of these are same as in DMP, so learning them should not be very
  161. difficult...)
  162.  
  163.         Alt-X           Quick exit
  164.         Left/Right      Next / Previous position
  165.         Up/Down         Select active channel
  166.         Esc             Exit with fade out
  167.         +/-             Increase / Decrease master volume
  168.         D               Jump to DOS shell
  169.         1-9, 0          Toggle channels on/off
  170.         ,/.             Adjust active channel panning left / right
  171.         M               Set active channel panning to middle
  172.         L               Set active channel panning to left
  173.         R               Set active channel panning to right
  174.         U               Set active channel panning to surround
  175.         N               Next module
  176.  
  177. Plus some internal debugging keys (someone would try these anyway):
  178.         F               Lists all free blocks in heap
  179.         H               Lists all memory blocks in heap
  180.         B               Dumps the display to a binary file MIDPSCR.BIN
  181.  
  182.  
  183.  
  184.         Archive support
  185.         ---------------
  186.  
  187. MIDP also includes a primitive archive support, built as we ourselves
  188. needed it. When playing a file with extension .ZIP, .MDZ or .S3Z, MIDP
  189. first decompresses the file using PKUNZIP to the directory set by
  190. environment variable "TEMP", or to C:\ if none is set. Then the first
  191. file from that directory with same name as the archive (but with any
  192. extension) will be played and deleted immediately after playing starts.
  193. When multiple archives are being played, the decompression of the next
  194. start immediately after starting to play the previous one, to give
  195. almost uninterrupted background music.
  196.  
  197. Archive support will be enhanced in the future, after we implement some
  198. kind of configuration file, to include any archivers and extensions.
  199. But for now on this must do.
  200.  
  201.  
  202.  
  203.         The future
  204.         ----------
  205.  
  206. Future versions of MIDP will include:
  207.  
  208.         1. Configuration file, with ability to change archivers,
  209.            extensions, colors, palette and probably redefine some
  210.            characters from the display.
  211.  
  212.         2. Less bugs (depending on your bug reports).
  213.  
  214.         3. No debug code (if 2 ever comes true)
  215.  
  216.  
  217.  
  218.         Contact us
  219.         ----------
  220.  
  221. For bug reports, comments, questions etc., contact us:
  222.  
  223. email:
  224.         pekanga@freeport.uwasa.fi (Petteri Kangaslampi)
  225.         gurus2@freeport.uwasa.fi (Jarno Paananen)
  226.         Jarno_Paananen@sonata.fipnet.fi (Jarno Paananen,
  227.                 might be faster)
  228.  
  229. voice:
  230.         +358-31-646764 (Petteri Kangaslampi)
  231.         +358-31-3422147 (Jarno Paananen)
  232.         Please restrict your calls to 10.00 - 21.30, Finnish
  233.         time.
  234.  
  235. normal mail:
  236.         Petteri Kangaslampi
  237.         Simeoninkuja 4
  238.         FIN-36240 Kangasala 4
  239.         Finland
  240.  
  241.         Jarno Paananen
  242.         Puskalantie 6
  243.         FIN-37120 Nokia
  244.         Finland
  245.